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Description from the back of the Book

Tracer: A 6800 Debugging Program featuring

- Single step execution using dynamic break points

- Register examination and modification

- Memory examination and modification

This publication includes

- "Jack and the Machine Debug"

- Tracer Program Notes

- Complete Assembly and Source Listing

- Complete Object Code Listing

- Machine Readable Object Code

Tracer: An Aid to 6800 Program Debugging

Tracer Program Notes

This program was written as an aid to debugging machine language programs on Motorola 6800 microprocessor systems and was designed as an extension to MIKBUG (Motorola's monitor ROM), which is rather weak in debugging facilities. It provides program tracing and register modification functions, extends the MIKBUG memory-change functions and is capable of detecting illegal instructions or other bad code. Consisting of less than 1K bytes, it is a small package and can be loaded anywhere in memory. It cannot be put in ROM in its present form, however, since instruction modification is used in one spot. It can be used in systems without MIKBUG if IO routines are provided to replace those present in MIKBUG. The IO subroutine calls are made through jumps at the beginning of the program (see listing 1, lines 30 to 37). This facilitates patching the calls to suit other system monitors. Eight routines are used:

BADDR accepts four hex characters from the input device and returns the binary value in the index register.

BYTE accepts two hex characters and returns the binary value in the A register.

INEEE accepts a single ASCII character and returns it in the A register.

OUT2H outputs two hex digits (one byte) to the console device. The byte is pointed to by the index register.

OUT2HS is equivalent to OUT2H, except that a space is output after the two hex characters.

OUT4HS outputs four hex digits (2 bytes) pointed to by the index register, followed by a space.

OUTS outputs a single space to the console.

PDATA outputs a string of ASCII codes to the console until an end of string code (hexadecimal 04) is encountered. The pointer to the string is in the index register.

The stack must be moved to the appropriate address in the system. This patch appears at location INITER (line 68 of listing 1).

The program shown here was assembled on a 6800 system using Jack Hemenway's relocating assembler. All absolute addresses are in the entended (2 byte) form, despite the fact that the assembly starts at address zero. To relocate the program to any other address, add the starting address to every memory reference flagged as relocatable by the letter "R" in the listing just to the left of the label field. Note that Jack's assembler does not list the code for FCC assembler pseudo operation. This operation produces ASCII strings with one byte per character in the string. To enter the program from the listing, users must supply the hexadecimal equivalent of the ASCII strings, as found in table 2 on page 21, identified by their address in the listing.
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